{smcl}
{* 11jan2006}{...}
{hline}
help for {hi:condivreg}{right:(SJ6-3: st0033_2; SJ5-2: st0033_1; SJ3-1: 0033)}
{hline}

{title:Instrumental variables regression with potentially weak instruments}

{p 8 14 2}{cmd:condivreg} {it:depvar} [{it:indepvars}]
{cmd:(}{it:endogvar}{cmd:=}{it:varlist_iv}{cmd:)} {ifin}
[{cmd:,} {bind:[{cmd:2sls} | {cmd:liml}]}
{cmdab:nocons:tant} {cmdab:noinstcons:tant} {cmd:ar} {cmd:lm}
{cmd:interval} {opt l:evel(#)} {opt test(#)}]


{title:Description}

{p 4 4 2}
{cmd:condivreg} fits a linear regression using 2SLS or LIML of
{it:depvar} on {it:indepvars} and {it:endogvar} using {it:varlist_iv}
(along with {it:indepvars}) as instruments for {it:endogvar}.  It also
reports the confidence region and p-value for the coefficient on
the single endogenous variable based on the conditional likelihood ratio
(CLR) approach developed by Moreira (2003). Computation of the
conditional p-value for the CLR test uses the algorithm of Andrews,
Moreira, and Stock (2006). Andrews, Moreira, and Stock (2004) showed that
the CLR test is approximately optimal.  In particular, it dominates the
Anderson and Rubin (1949) test and the Lagrange multiplier (score) test
proposed independently by Kleibergen (2002) and Moreira (2001). Results
for the Anderson-Rubin and score tests are optionally provided. 


{title:Options}

{p 4 8 2}
{cmd:2sls} requests that the 2SLS estimator be used; this option is the
default.

{p 4 8 2}
{cmd:liml} requests that the LIML estimator be used. {cmd:2sls} and
{cmd:liml} are mutually exclusive.

{p 4 8 2}
{cmd:noconstant} indicates that no constant term is to be included in the
regression equation. The default is to include a constant term.

{p 4 8 2}
{cmd:noinstconstant} indicates that no constant term is to be included in
the first-stage regression of the endogenous variable on the instruments
and exogenous variables. Stata's {cmd:ivreg} command excludes a constant
from both equations if its {cmd:noconstant} option is specified. 
Usually one will not want to specify {cmd:noinstconstant} unless
{cmd:noconstant} is also specified, but we give the user the option to
experiment. By default, a constant term is included.

{p 4 8 2}
{cmd:ar} provides the coverage-corrected confidence set and
size-corrected p-value based on the Anderson-Rubin test statistic. 

{p 4 8 2}
{cmd:lm} provides the coverage-corrected confidence set and
size-corrected p-value based on the Lagrange multiplier (score) test statistic.

{p 4 8 2}
{cmd:interval} displays the confidence interval, which is the minimal
convex interval containing the coverage-corrected confidence set. 

{p 4 8 2}
{cmd:level(}{it:#}{cmd:)} specifies the confidence level, as 
a percentage, for confidence intervals.  The default is 
{cmd:level(95)} or as set by {helpb set level}.

{p 4 8 2}
{cmd:test(}{it:#}{cmd:)} contains the hypothesized value of the
endogenous variable's coefficient. The default is {cmd:test(0)}.


{title:Examples}

{p 4 8 2}{cmd:. condivreg y1 x1 (y2 = z1 z2 z3), liml interval}{p_end}

{p 4 8 2}{cmd:. condivreg y1 x1 (y2 = z1 z2 z3 z4), ar lm test(0.1) }{p_end}


{title:References}

{p 4 8 2}
Anderson, T. W., and H. Rubin. 1949. Estimators of the parameters of a
single equation in a complete set of stochastic equations.
{it:Annals of Mathematical Statistics} 20: 46--63.

{p 4 8 2}
Andrews, D. W. K., M. Moreira, and J. Stock. 2004. Optimal invariant tests for
instrumental variables regression. Unpublished manuscript.

{p 4 8 2}
Andrews, D. W. K., M. Moreira, and J. Stock. 2006. Performance of conditional 
Wald tests in IV regression with weak instruments.
{it:Journal of Econometrics}. Forthcoming.

{p 4 8 2}
Kleibergen, F. 2002. Pivotal statistics for testing structural parameters in
instrumental variables regression. {it:Econometrica} 70: 1781--1803.

{p 4 8 2}
Moreira, M. 2001. Tests with correct size when instruments can 
be arbitrarily weak. Center for Labor Economics Working Paper 37, 
UC Berkeley.

{p 4 8 2}
Moreira, M. 2003. A conditional likelihood ratio test for
structural models. {it:Econometrica} 71: 1027--1048.


{title:Also see}

{p 4 13 2}Manual:  {hi:[R] ivreg}

{p 4 13 2}Online:  {helpb ivreg}
{p_end}
